home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1997 September / Macworld (1997-09).dmg / Shareware World / Utilities / Text Processing / Alpha / Help / LaTeX Help < prev    next >
Text File  |  1997-02-24  |  38KB  |  667 lines
  1. ===========================================================================
  2. ALPHA LaTeX MACROS
  3. ===========================================================================
  4.  
  5. Welcome to the Alpha LaTeX macros, a package designed to simplify the 
  6. input and processing of LaTeX documents.  This is the "LaTeX Help" 
  7. file available from the System help menu (under the question mark).  
  8. To navigate this file quickly, activate the window's mark menu by 
  9. pressing the 'M' icon on the toolbar at the right.
  10.  
  11. This help file is an Alpha hypertext document.  On a color monitor, 
  12. links are colored green and underlined.  (On a monochrome monitor, 
  13. they are just underlined.)  Click on a link to jump to another part of 
  14. the document or open another help file.  Press <Ctl .> to return the 
  15. cursor to its previous position.  Note: Some links are URLs to 
  16. documents on the World Wide Web, which require an Internet connection.  
  17. These are surrounded by angle brackets < > below.
  18.  
  19. This is the help file for latex.tcl 3.2t (compatible with LaTeX 2e). 
  20. For backward compatibility with LaTeX 2.09, users of the full
  21. version of Alpha (not AlphaLite) may install latex.tcl 2.0 by
  22. choosing 'install:latex 2.09' from the Config menu.
  23.  
  24. ----------------------------------------------------------------------
  25.  
  26. The following Alpha LaTeX help documents are available:
  27.  
  28.     • User's Guide:        an introduction to the Alpha LaTeX macros
  29.     • LaTeX Menus:         commands and bindings (organized by menu)
  30.     • LaTeX Key Bindings:  commands and bindings (organized by command key)
  31.  
  32. Clicking on one of these links opens a .tex file and inserts the LaTeX 
  33. menu into your menubar.  To typeset the document, pull down the LaTeX 
  34. menu and choose the 'typeset' command on the Typeset submenu (or press 
  35. <Cmd T>).  Choose the 'view' or 'print' command on the Typeset submenu 
  36. to view or print the document (or press <Shf Cmd V> or <Shf Cmd P>), 
  37. respectively.
  38.  
  39. The User's Guide has been converted to HTML (with LaTeX2HTML) and is 
  40. included with the full version of Alpha:
  41.  
  42.     • User's Guide:        an introduction to the Alpha LaTeX macros
  43.  
  44. Click on the above link to open the corresponding .html file and 
  45. insert the HTML menu into your menubar.  To view the document in your 
  46. browser, pull down the HTML menu and choose the 'Send file to browser' 
  47. command (or press <Shf Cmd S>).
  48.  
  49. AlphaLite users may obtain the HTML version of the User's Guide by 
  50. downloading an archive from the Web:
  51.  
  52.   <http://www.npac.syr.edu/users/trscavo/Alpha/latex_docs.sit.hqx>
  53.  
  54. After this file is downloaded and unpacked, move the "LaTeX" folder 
  55. from the archive into the same folder as the Alpha application, 
  56. replacing the incomplete "LaTeX" folder that's already there.
  57.  
  58. The latest version of the HTML User's Guide is also online at URL
  59.  
  60.   <http://www.npac.syr.edu/users/trscavo/Alpha/docs/latex_guide/>
  61.  
  62. Also, if you have a moment, please visit my LaTeX Web page:
  63.  
  64.     An Introduction to LaTeX and AMS-LaTeX
  65.     <http://web.syr.edu/~trscavo/latex.html>
  66.  
  67. Happy LaTeXing!
  68.  
  69. Cheers,
  70. Tom Scavo
  71. <mailto:trscavo@syr.edu>
  72. <http://web.syr.edu/~trscavo/>
  73.  
  74.  
  75. ===========================================================================
  76. VERSION HISTORY
  77. ===========================================================================
  78.  
  79. Changes in Version 3.2t
  80.  
  81.  • Added a new Textures's interface, specifically designed for 
  82.  Textures version 1.8.  The primary advantage of Textures over the 
  83.  other TeX implementations is the capability of multiple windows, 
  84.  which Alpha now supports.
  85.  • Added non-functional menu filters to the Text Size, International, 
  86.  and Arrows submenus, which appears to fix some problems.  (I have no 
  87.  idea why this works!)  Thanks to Johan Linde <jl@theophys.kth.se> for 
  88.  the suggestion.
  89.  • Fixed the 'll' command on the Relations submenu.
  90.  • Fixed a bug that prevented users from specifying the "latexMenu" 
  91.  in Config:Global:Menus.
  92.  • Updated the LaTeX documentation (see above for pointers).
  93.  
  94. Changes in Version 3.2
  95.  
  96.  • Rewrote and reorganized the Alpha LaTeX documentation.  The primary 
  97.  help file is now distributed as both a LaTeX file and an HTML file 
  98.  (generated by latex2html).  See the "LaTeX Help" document on the 
  99.  System help menu (under the question mark) for a summary.
  100.  • Totally rewrote latexMenu.tcl so that it's more modular.  Users may 
  101.  now easily modify the LaTeX menu.  (See the "Installation" section 
  102.  in the new User's Guide.)
  103.  • Implemented Chris Higgins' <C.Higgins@cit.gu.edu.au> version of 
  104.  latexProjects.tcl.  Later implemented Vince Darley's
  105.  <vince@das.harvard.edu> more powerful version of latexProjects.tcl.  
  106.  In the end, however, Vince incorporated LaTeX projects directly into 
  107.  the Fileset menu.
  108.  • Put 'typeset' on a dynamic submenu called Typeset.  The 'typeset' 
  109.  command (bound to <Cmd T>) now displays the name of the file to be 
  110.  typeset.  If the current file can not be typeset (e.g., if it's a .log 
  111.  file or an .aux file) or if there are no open windows, the user is 
  112.  asked to locate a file to be typeset.
  113.  • Modified 'typesetSelection' so that it resolves top-level input 
  114.  files.  In other words, there's a high probability that the current 
  115.  selection will be typeset by the TeX app without error or warning.  
  116.  Thanks to Pierre Basso <Pierre.Basso@lim.univ-mrs.fr> for bug reports 
  117.  and advice.
  118.  • Added a 'typesetClipboard' command to the Typeset submenu, bound 
  119.  to <Shf Cmd T>.  The contents of the clipboard are sent to the TeX 
  120.  application in a plain vanilla LaTeX wrapper.
  121.  • Added 'viewDVI' and 'printDVI' to the Typeset submenu, bound to <Shf 
  122.  Cmd V> and <Shf Cmd P>, respectively.  Also added 'dvips', 'viewPS', 
  123.  and 'printPS' to the Typeset submenu.  All commands display the name 
  124.  of the file to be processed.
  125.  • Added 'bibtex' and 'makeindex' to the Typeset submenu.  All known 
  126.  BibTeX and MakeIndex apps are supported.
  127.  • Any LaTeX auxiliary file (.log, .aux, etc.) may be opened and 
  128.  displayed.  While the Typeset submenu is down, press the option key 
  129.  to see various 'open' commands.  Other such commands are found on 
  130.  the "Other Files" submenu on the Typeset submenu, including a 
  131.  command that lets you open any file in the current directory (bound 
  132.  to <Shf Cmd O>).
  133.  • Relocated the 'removeAuxiliaryFiles' command from the LaTeX Utilities 
  134.  submenu to the new Typeset submenu.
  135.  • Alpha LaTeX now writes all temporary files to "$PREFS:tmp:", which 
  136.  makes them easier to remove.  All temporary files are removed once, 
  137.  at launch; however, the new command 'removeTemporaryFiles' on the 
  138.  Typeset submenu removes all temporary files immediately.
  139.  • The short menu is now installed by default.  Remove the tick on 
  140.  "Short LaTeX Menu" (a checkable menu item) on the "LaTeX Utilities" 
  141.  submenu to install the long menu.
  142.  • Alpha now launches applications by signature, not name.  This 
  143.  means you can freely change the names of your TeX-related apps, so 
  144.  long as the applications themselves don't mind. :-)  Application 
  145.  signatures may be viewed and removed with the 'viewSavedSetting' and 
  146.  'removeSavedSetting' commands on the Config menu.
  147.  • Every time 'texSig' is altered (either by choosing the command
  148.  'removeSavedSetting' on the Config menu or opening a new TeX app), 
  149.  the LaTeX menu is rebuilt and the corresponding small icon is 
  150.  inserted into Alpha's menu bar.  For most users, this will be a 
  151.  one-time operation.
  152.  • Alpha's TeX mode search path (used when cmd-dbl-clicking the 
  153.  arguments of \input and \include commands, for instance) has been 
  154.  extended to *two* levels of subfolders.  First, the current directory 
  155.  is searched, then 'TeXInputs' (a global variable optionally set with 
  156.  the 'appPaths' command on the Config menu) and finally any TeX-inputs 
  157.  folder recognized by your TeX app.  The search path is generated the 
  158.  first time it's needed (rather than on-the-fly) and thereafter when 
  159.  the values 'texSig' or 'TeXInputs' are changed (i.e., not very often).
  160.  • The proc 'buildSubMenu' in DblClickAux.tcl has been modified 
  161.  to accomodate its use in latexMenu.tcl.  (See below for a 
  162.  description of the new 'packages' submenu.)
  163.  • Redesigned the Documents submenu.  Choosing "New Document" (or 
  164.  pressing <Shf Cmd N>) brings up a dialog with a pop-up menu of 
  165.  standard document types.  This command creates a new TeX window, 
  166.  inserts a document of the requested type, and automatically runs 
  167.  the 'options' command (which is still on the Documents submenu).  
  168.  The old commands 'article', 'letter', etc. will be found on the 
  169.  "Insert Document" subsubmenu.  Each such command behaves as it did 
  170.  before, that is, it inserts a document template into an empty window 
  171.  or wraps the entire contents of the current window.
  172.  • Modified the 'usepackage' command (bound to <Ctl Opt U>) on the 
  173.  Documents submenu so that it inserts "\usepackage" immediately after 
  174.  the \documentclass command regardless of the current location of the 
  175.  insertion point.
  176.  • Added 'filecontentsAll' to the Documents submenu, which creates a 
  177.  single, self-contained LaTeX document (for file transfer, say) from 
  178.  the current document.
  179.  • Added a flag called 'buildPkgsSubmenu', which is turned off by 
  180.  default.  Check this flag in the 'currentMode:flags' dialog on the 
  181.  Config menu to enable the Packages submenu (see below).
  182.  • The Packages submenu contains a list of all packages known to the 
  183.  TeX app.  Choosing one of these packages inserts the corresponding 
  184.  \usepackage command into the preamble of the current document.  To 
  185.  build this submenu, enable the flag 'buildPkgsSubmenu' as described 
  186.  above, and then choose the 'rebuildDocumentsSubmenu' command on the 
  187.  Documents submenu.
  188.  • SmartScripts are temporarily turned off when the cursor is inside 
  189.  the required argument of any LaTeX command taking a filename as input 
  190.  (e.g., \input, \include, \usepackage, \documentclass, etc.).  Vince 
  191.  Darley <vince@das.harvard.edu> provided the essential ingredient for 
  192.  this new feature.
  193.  • The commands 'latex', 'bibtex', and 'makeindex' on the Goto 
  194.  submenu recognize additional TeX-related applications.
  195.  • Added 'writeFile' (complementary to 'readFile') to DblClickAux.tcl.
  196.  • Improved the DirectTeX Pro interface courtesy of Ivan Alves 
  197.  <ivan.alves@ci.educ.lu>.
  198.  • Added the general-purpose procs 'buildStructure', 'insertStructure',
  199.  'wrapStructure', and 'doWrapStructure' to latexEngine.tcl.  (Tcl 
  200.  programmers take note!)
  201.  • Added the flag 'useBrackets', set to false, by default.  If set 
  202.  to true, "\[...\]" will be used in multi-line math displays instead 
  203.  of "\begin{displaymath}...\end{displaymath}".
  204.  • The body of a table or figure environment now begins with a 
  205.  \centering command (not \centerline).
  206.  • Multi-line delimiters have finally arrived!  With the Delimiters 
  207.  submenu down, press the <Opt> key to see the possibilities.
  208.  • Added 'overrightarrow' and 'overleftarrow' to the Grouping submenu.
  209.  • Fixed a bug in 'gotoTabStop', a proc in latexMacros.tcl used by 
  210.  'nextTabStop' and 'prevTabStop'.
  211.  • Changed the command key for the 'chooseCommand' command on the 
  212.  LaTeX Utilities submenu from <Shf Cmd T> to <Shf Cmd C>.  (Sorry, 
  213.  Pete!)
  214.  • Changed the name of the TeX mode variable 'boxMacroName' to 
  215.  'boxMacroNames'.  The latter now takes a *list* of macro names, which 
  216.  is set to "includegraphics includegraphics*" by default.
  217.  • The TeX mode flag 'useBoxMacro' is gone.  When inserting a figure 
  218.  environment, the user is asked to choose one of the box macros stored 
  219.  in 'boxMacroNames'.  If the choice is left blank, the current 
  220.  selection (if there is one) is wrapped inside the figure environment.
  221.  
  222. Changes in Version 3.1
  223.  
  224.  • Pete added Vince Darley's excellent fill routines to Alpha proper.  
  225.  LaTeX users, in particular, will notice big improvements when filling 
  226.  paragraphs and regions in TeX mode.
  227.  • Implemented a shortened version of the LaTeX menu, which may be 
  228.  installed by checking 'shortLaTeXMenu' on the LaTeX Utilities submenu.
  229.  • Fixed some bugs in 'chooseCommand' and generalized it so that other 
  230.  modes could use it as well.  Changed its command key from <Opt Cmd T> 
  231.  to <Shf Cmd T> to accomodate the new 'typesetSelection' command 
  232.  described below.
  233.  • Added a new command called 'typesetSelection' <Opt Cmd T>, which 
  234.  typesets any selection (i.e., region) within the document environment.  
  235.  To see this new command, pull down the main menu, and with the cursor on 
  236.  the 'typeset' command, press the <Opt> key.
  237.  • The LaTeX utility 'removeAuxiliaryFiles' now searches for ALL auxiliary 
  238.  files in the current directory, regardless of the base filename.  Two 
  239.  buttons were also added to the dialog:  the command "rm ext" removes all 
  240.  files with the same extension as the file displayed in the dialog, and 
  241.  "rm all" removes all auxiliary files from the current directory without 
  242.  prompting.
  243.  • Tightened the input validation routines used in 'nthTabStop', 
  244.  'enumerate', 'itemize', 'description', 'thebibliography', 'tabular', 
  245.  'eqnarrayStar', 'eqnarray', and 'myArray'.  [Note:  Tcl programmers
  246.  will want to look at the generally useful routines 'isInteger', 
  247.  'isUnsignedInteger', and 'isPositiveInteger' in latexEngine.tcl.]
  248.  • Fixed a bug in the automatic typesetting routines that prevented 
  249.  Alpha from finding the PPC version of Textures.
  250.  • Improved the communication between Alpha and DirectTeX Pro.  
  251.  (Thanks to Alun Carr <ajcarr@ccvax.ucd.ie> and Ivan Alves
  252.  <alves@econ.ubc.ca> for this modification.)
  253.  • 'TeXMarkFile' now marks \input and \include files (thanks to Vince 
  254.  Darley).  To mark a file, choose "Mark File" on the mark menu on the 
  255.  tool bar at the right of each window.
  256.  • The keybindings for '(la)texMath' and '(la)texDisplaymath' on the 
  257.  Math Modes submenu have been changed to <Ctl Cmd M> and <Ctl Opt Cmd 
  258.  M>, respectively, primarily for compatibility with international 
  259.  keyboards.  The old keybindings <Ctl Cmd 4> and <Ctl Opt Cmd 4> are 
  260.  still available, however.
  261.  • The 'insertReference' command (formerly on the LaTeX Utilities 
  262.  submenu) has been removed to make way for Vince Darley's new 
  263.  improved 'ref' and 'pageref' commands (see below).
  264.  • To use Vince Darley's new reference completion facility:  press 
  265.  <Ctl Opt X> or <Ctl Opt P> to insert a \ref or \pageref command, 
  266.  respectively.  The inserted command will contain the argument of the 
  267.  nearest \label command.  Continue pressing <Ctl Opt X> or <Ctl Opt P> 
  268.  to cycle through all the \label commands in your document.
  269.  • Fixed a serious bug with 'useBoxMacro' and 'boxMacroName'.  (See 
  270.  the "LaTeX Help" file for descriptions of these TeX variables.)
  271.  • Updated and polished the Alpha LaTeX document latex_macros.tex 
  272.  (commands organized by menu) and created a new latex_bindings.tex 
  273.  (commands organized by command key), both of which are found in 
  274.  Alpha's LaTeX folder.
  275.  • The commands 'oneParameter' <Ctl Cmd 1> and 'twoParameters' 
  276.  <Ctl Cmd 2> no longer bring up a dialog (which just gets in the way).  
  277.  If there is a selection, these commands now wrap that selection.
  278.  • All the commands on the Text Style submenu now have command keys, 
  279.  namely, <Ctl Opt 1>, <Ctl Opt 2>, etc., through <Ctl Opt 0>.
  280.  • Each of the commands 'lim', 'inf', 'sup', 'liminf', 'limsup', 
  281.  'min', and 'max', now inserts a subscript automatically.  For 
  282.  example, the 'lim' command (now bound to <Ctl Cmd L>) inserts 
  283.  the string "\lim_{•}".  After insertion, press the <Del> key twice 
  284.  to get rid of this subscript, if desired.
  285.  • Changed the name of 'custom' to 'generic' on the Documents 
  286.  submenu, and assigned it the command key <Ctl Opt D>.
  287.  • Added 'usepackage' to the Documents submenu, bound to <Ctl Opt U>. 
  288.  • Added 'verb' to the Miscellaneous submenu, bound to <Ctl Opt V>.
  289.  • Bound 'underbrace' and 'overbrace' to <Ctl Opt Cmd U> and
  290.  <Ctl Opt Cmd O>, respectively.
  291.  • Added the declarative counterparts to each of the Text Style 
  292.  commands.  These can be seen by pulling down the Text Style submenu 
  293.  and pressing the <Shf> key.
  294.  • Added 'nocite' <Shf Ctl Opt C> to the Miscellaneous submenu.
  295.  
  296.  
  297. Changes in Version 3.0
  298.  
  299.  • Designed and implemented a totally new set of key bindings.  This 
  300.  was necessary because the old LaTeX bindings conflicted with Alpha's 
  301.  new key bindings and many international keyboards.
  302.  • The LaTeX menu now displays key bindings, whenever possible.
  303.  • Fixed a bug in "latexSmart.tcl" (formerly "smart.tcl") which prevented 
  304.  a user from typing a literal double quote (\").
  305.  • Added a 'smartQuotes' flag to the default list of flags on the "check" 
  306.  pop-up menu, so that users could turn off this feature on demand.
  307.  • Added 'convertQuotes' to the LaTeX Utilities submenu.  If there 
  308.  is a selection, 'convertQuotes' converts all straight quotes to 
  309.  curved quotes (LaTeX-style) within the selection; otherwise, it 
  310.  processes the entire window.
  311.  • Added a "smart dots" feature so that three consecutive dots (...) 
  312.  are automatically replaced with \ldots.  This can be turned off with 
  313.  the 'smartDots' flag on the "check" pop-up menu.
  314.  • Smart quotes and dots can be escaped on-the-fly by pressing the 
  315.  <Delete> key.  For example, with 'smartQuotes' enabled, type a double
  316.  quote at the keyboard.  Unless preceded with a backslash, this double
  317.  quote will automatically be replaced by a pair of curved single quotes
  318.  (LaTeX-style).  Pressing the <Delete> key will bring the original double 
  319.  quote back.
  320.  • Added a 'smartScripts' flag to the "check" pop-up menu.  Enabled by 
  321.  default, this feature binds the <_> and <^> keys to 'formulas:subscript' 
  322.  and 'formulas:superscript', respectively.  As with smart quotes and dots, 
  323.  smart scripts may be escaped on-the-fly by pressing the <Delete> key.
  324.  • Fixed a bug that inserted an extra blank line between the rows of 
  325.  an array environment.
  326.  • Repaired the note environment.
  327.  • Added DirectTeX Pro and Euro-OzTeX to the list of supported TeX 
  328.  implementations.  (Thanks to Alun Carr and Michel Moreaux for the 
  329.  patches.)
  330.  • The proc 'typeset' now processes an untitled or unsaved TeX window 
  331.  by first asking the user if the window should be saved.  If the answer 
  332.  is "no", then 'typeset' goes ahead and passes the contents of the window 
  333.  to the LaTeX application anyway, which is very handy for on-the-fly 
  334.  testing and debugging.  Temporary files are stored in $PREFS and cleaned 
  335.  up the next time Alpha launches.
  336.  • Added the flag 'runTeXInBackground' to the "check" pop-up menu.  Tick 
  337.  this option if you want to 'typeset' your LaTeX documents in the 
  338.  background.
  339.  • Added 'fillColumn' and 'leftFillColumn' to the default list of 
  340.  TeX mode variables available on the "check" pop-up menu.
  341.  • The 'useDollarSigns' flag works again!
  342.  • Fixed numerous bugs in the proc 'convertDollarSigns'.
  343.  • This version of latex.tcl completely takes over the numeric keypad 
  344.  (except for the clear/numLock key, which now toggles the keypad in 
  345.  any mode).
  346.  • Added many new navigation commands to the Goto submenu:  'prevCommand' 
  347.  <Kpad4>; 'nextCommand' <Kpad6>; 'prevCommandSelect' <Shf Kpad4>; 
  348.  'nextCommandSelect' <Shf Kpad6>; 'prevEnvironment' <Cmd Kpad4>; 
  349.  'nextEnvironment' <Cmd Kpad6>; 'prevEnvironmentSelect' 
  350.  <Shf Cmd Kpad4>; and 'nextEnvironmentSelect' <Shf Cmd Kpad6>.
  351.  Also added two additional commands on an experimental basis:  
  352.  'prevCommandSelectWithArgs' <Shf Opt Kpad4> and 
  353.  'nextCommandSelectWithArgs' <Shf Opt Kpad6> (see Bugs below).
  354.  • In addition to the old navigation commands 'prevSection' 
  355.  <Cmd Kpad8>, 'nextSection' <Cmd Kpad2>, 'prevSubsection' 
  356.  <Kpad8>, and 'nextSubsection' <Kpad2>, there are four new commands 
  357.  'prevSectionSelect' <Shf Cmd Kpad8>, 'nextSectionSelect' 
  358.  <Shf Cmd Kpad2>, 'prevSubsectionSelect' <Shf Kpad8>, and 
  359.  'nextSubsectionSelect' <Shf Kpad2>.  The latter make it easy to 
  360.  select large blocks of text (i.e., complete sections or subsections).
  361.  • Fixed some minor bugs in the tab stop mechanism, including a 
  362.  bug in 'gotoTabStop' that caused it to find a tab stop immediately 
  363.  to the right of the cursor when searching backwards, and another in 
  364.  'nthTabStop'.  The latter now handles ANY input, including zero.
  365.  • The following interactive procedures now validate the user's input:
  366.  'nthTabStop', 'enumerate', 'itemize', 'description', 'thebibliography', 
  367.  'tabular', 'myArray', 'eqnarrayStar', 'eqnarray'.  Invalid input 
  368.  simply causes the procedure to terminate.
  369.  • Put 'insertLiteralTab' and 'insertTabStop' on the LaTeX Utilities 
  370.  submenu, if for no other reason but to advertise the key bindings.  
  371.  Note:  The proc 'insertTabStop' is bound to <Opt 8> on US keyboards.
  372.  • The 'filecontents' command on the Documents submenu finally works!
  373.  • Removed 'loadSymbolPackage' from the LaTeX Utilities submenu 
  374.  because the symbol package (latexsym) can be loaded with the 
  375.  'packages' command on the Documents submenu.  The latter now checks 
  376.  to see if the chosen package is already loaded.
  377.  • Merged 'item' and 'bibitem' on the Miscellaneous submenu into a 
  378.  single command: 'item' now inserts either \item, \item[], or \bibitem{} 
  379.  depending on the context, and is bound to <Ctl Opt J>.
  380.  • Reorganized the Math Environments submenu for conceptual purposes.  
  381.  (The array environment, in particular, is different than the other 
  382.  environments since it MUST be used in math mode, whereas the others 
  383.  must NEVER be used in math mode).
  384.  • The table environment now puts the caption at the top.  (The 
  385.  figure environment still puts the caption at the bottom.)
  386.  • Tom Pollard fixed 'TeXMarkFile' so that the "{}" pop-up menu is 
  387.  more readable.
  388.  • Using Alpha's new command-double-click facility, Tom Pollard 
  389.  wrote a routine that chases references and citations.  Simply 
  390.  command-double-click the required argument of a \ref or \cite 
  391.  (which are now underlined) to find the corresponding \label or 
  392.  \bibitem, respectively.  It will even open a .bib file, if necessary.
  393.  • Andreas Amann added \pageref, \input, \include, and \bibliography 
  394.  to the list of (underlined) commands whose required arguments can now 
  395.  be command-double-clicked.
  396.  • Added \usepackage, \documentclass, \RequirePackage, and \LoadClass to 
  397.  the list of (underlined) LaTeX commands.  Also, the required argument of 
  398.  the command specified in the TeX mode variable 'boxMacroName' 
  399.  (\includegraphics, by default) may also be command-double-clicked.
  400.  • The user-defined variable 'boxMacroName' on the "check" pop-up menu 
  401.  is now dimmed if the flag 'useBoxMacro' is set to false.
  402.  • Changed the name of the "Styles" command to "Options", and added 
  403.  the remaining standard options to the corresponding pop-up menu.
  404.  • Renamed some of the commands on the Formulas submenu.
  405.  • Totally reorganized the Arrows submenu.  With the menu down, 
  406.  press any modifier key to see the double arrow commands.
  407.  • Shortened the Greek submenu considerably.  With the menu down, 
  408.  press any modifier key to see the upper-case Greek letters.
  409.  • The Greek letters have a new set of key bindings.  See the description 
  410.  of the new Greek submenu below.
  411.  • Added 'removeAuxiliaryFiles' to the LaTeX Utilities submenu, 
  412.  which interactively removes all auxiliary files (.aux .bbl .dvi .glo 
  413.  .idx .ind .lof .log .lot .toc .blg .clg .ilg .ps) for the current 
  414.  document in the current directory.
  415.  • Added 'deleteComments' to the LaTeX Utilities submenu.
  416.  • Reorganized the Miscellaneous submenu.
  417.  • Pete added a nifty keyboard-bound method of invoking any LaTeX menu 
  418.  command.  It's called 'chooseCommand' (bound to <Opt Cmd T>) and it's 
  419.  on the LaTeX Utilities submenu.
  420.  • Vince Darley wrote a handy utility called 'insertReference' on the 
  421.  LaTeX Utilities submenu that displays a list of labels defined in the 
  422.  current document.  Choosing one of them inserts the corresponding \ref 
  423.  at the insertion point.
  424.  
  425.  
  426. Changes in Version 2.3
  427.  
  428.  • A handy install mechanism (designed and implemented by Tom Pollard) 
  429.  lets the user choose between the old LaTeX macros (aka LaTeX 2.09) 
  430.  and the current version (which is LaTeX 2e-compatible).  Simply choose 
  431.  'install:LaTeX' on the Utils menu to switch versions.
  432.  • Totally redesigned the kernel so that the insertion of LaTeX 
  433.  environments and document templates is faster and less choppy.
  434.  • The 'typeset' command is now bound to <Cmd T> (thanks, Pete!) and 
  435.  supports version 2.2 of CMacTeX (courtesy of its author, Tom Kiffe)
  436.  as well as DirectTeX running under MPW (Alun Carr <ajcarr@ccvax.ucd.ie> 
  437.  provided the relevant code).  Alpha now supports all known Macintosh 
  438.  TeX implementations!
  439.  • A crude command completion mechanism has been implemented (see the 
  440.  section on "Command Completion" at the bottom of this document).
  441.  • The navigation commands 'bibtex' and 'makeindex' are now on the 
  442.  Goto submenu (compliments of Tom Pollard).
  443.  • Added \textnormal to the Text Style submenu.  It has no corresponding 
  444.  command key, by default.
  445.  • Added 'flushleft' and 'flushright' commands to the Environments 
  446.  submenu on either side of 'center'.
  447.  • Added a new Utilities submenu.  There's a procedure called 'clearTabStops' 
  448.  (bound to <Cmd Tab>) which removes all tab stops, and another proc called 
  449.  'convertDollarSigns' which replaces all dollar signs with appropriate LaTeX 
  450.  syntax (see the "MathModes" section of this document).  Both these commands 
  451.  act on the current document or the current selection (if there is one).  
  452.  Another command called 'loadSymbolPackage' carefully inserts the string 
  453.  "\usepackage{latexsym}" into the current document (see p.42 of the _LaTeX_ 
  454.  book).
  455.  • Added 'smallskip', 'medskip', and 'bigskip' to the Spacing submenu.
  456.  • Modified 'filecontents' on the Documents submenu so that the user is 
  457.  presented with a standard file dialog for selecting the file to be 
  458.  prepended to the current document.
  459.  • Fixed a bug in "latexKeys.tcl" (reported by Christian Konrad 
  460.  <Konrad@dax1.w7.ipp-garching.mpg.de>) that prevented Bib mode from 
  461.  initializing TeX mode.
  462.  • Both the figure and table environments now have optional arguments.
  463.  • Added the flag 'promptNoisily' to the "flags" pop-up menu.
  464.  • Listed many of the corresponding command keys in the "LaTeX Help" 
  465.  file (i.e., this file).
  466.  • Fixed a bug (reported by Jonathan Guyer <j-guyer@nwu.edu>) which
  467.  caused some latex.tcl routines to inadvertently alter the search
  468.  string (in the Find dialog).  A recent Alpha enhancement made this
  469.  bug fix possible.
  470.  
  471.  
  472. Changes in Version 2.2
  473.  
  474.  • Improved the messages throughout.  (These can be read from the status 
  475.  bar at the bottom of your screen.)
  476.  • Significantly enhanced the letter documentclass template.
  477.  • The 'typeset' command (formerly called 'Latex') on the LaTeX menu not 
  478.  only switches to the appropriate LaTeX app (Textures and OzTeX are 
  479.  currently supported), but also TeXs the current document automatically, 
  480.  with a single keystroke.  (Thanks to Tom Pollard for assistance.)
  481.  • Interchanged the command keys assigned to 'eqnarray' and 'eqnarrayStar' 
  482.  so that they parallel those assigned to 'displaymath' and 'equation'.  
  483.  As a result, un-numbered equations begin with the <Shf Opt> modifier while 
  484.  numbered equations begin with <Ctl Opt>.  Also, 'eqnarrayStar' comes before 
  485.  'eqnarray' on the Math Environments submenu.
  486.  • Changed the command keys for the 'slide', 'tabular', and 'thebibliography' 
  487.  environments.  (These changes were needed to make way for new environments).  
  488.  See the files "latex_commands.tex" and "latex_keys.tex" for a complete list 
  489.  of command keys suitable for printing.
  490.  • Changed "\documentstyle" to "\documentclass" in the document templates 
  491.  to conform with LaTeX 2e syntax.  Added a generic "\usepackage" command to 
  492.  each of the templates.
  493.  • Added the \appendix declaration to the Sectioning submenu.
  494.  • Reorganized the Text Style menu according to LaTeX 2e conventions.
  495.  Changed "{\em }" to "\emph{}", "{\it }" to "\textit{}" and "{\sl }" 
  496.  to "\textsl{}", and removed the italic correction on all three (which 
  497.  LaTeX 2e now handles automatically).  Also changed "{\sc }" to "\textsc{}", 
  498.  "{\bf }" to "\textbf{}", "{\rm }" to "\textrm{}", "{\sf }" to "\textsf{}", 
  499.  and "{\tt }" to "\texttt{}".  Added \underline (which works in any mode), 
  500.  as well as \textup and \textmd (the default shape and series, 
  501.  respectively).  The latter two commands do not have assigned command 
  502.  keys, by default.
  503.  • Added four new math styles to the Math Style submenu:  "\mathrm", 
  504.  "\mathbf", "\mathsf", and "\mathtt".  Changed the name of "\mit" to 
  505.  "\mathit" and "\cal" to "\mathcal".  Relocated the Math Style submenu 
  506.  higher up on the LaTeX menu.
  507.  • Added support for the new "slides" documentclass, and the associated 
  508.  environments "slide", "overlay", and "note".
  509.  • Implemented the Functions submenu, a menu of 34 log-like functions.
  510.  • Added omicron to the Greek submenu, for completeness.
  511.  • Added many commands, too numerous to mention by name, to the Binary 
  512.  Operations, Relations, Arrows, Symbols, and Large Operators submenus.
  513.  • Some LaTeX 2e symbols require the input of a special symbol package.  
  514.  In latex.tcl, before such a symbol is inserted into the text, a macro 
  515.  automatically checks to see if the required symbol package is loaded.  
  516.  If not, the user may opt to have the program install it automatically.
  517.  • Added a Page Layout submenu and macros to insert a title page and 
  518.  abstract.  There is also a 'maketitle' command which inserts a template 
  519.  into the current document and positions it automatically.  (Note:  The 
  520.  "titlepage" style is often used in conjunction with \maketitle.  See the 
  521.  'styles' command on the Documents submenu.)  Other page layout commands 
  522.  have also been added.
  523.  • Fine tuned the insertion macros so that input is less choppy.
  524.  • Command names now mimic their LaTeX 2e counterparts as much as possible.
  525.  • Streamlined the code underlying the Delimiters submenu.
  526.  • Added a 'center' command to the Environments submenu.
  527.  • By default, <Opt Cmd $> and <Shf Opt Cmd $> are respectively bound to 
  528.  'latexMath' and 'latexDisplaymath' (previously, these keys were bound 
  529.  to 'texMath' and 'texDisplaymath').  Users wanting to use the old-style 
  530.  dollar signs to invoke math mode should set the flag 'useDollarSigns' to 
  531.  true.
  532.  • TeX mode now recognizes the suffixes .ltx, .dtx and .ins, in addition 
  533.  to .tex and .sty.  (Note that the suffixes are case sensitive, however.)
  534.  • Restored the <Opt 8> keystroke to its default Macintosh setting 
  535.  (which necessitated moving \bullet to <Opt Cmd 8>).  Thus <Opt 8> 
  536.  inserts a literal bullet into the .tex document.  Bullets may be used 
  537.  in conjunction with the tab stop mechanism (<Tab> and <Shf Tab>), and 
  538.  are great for setting "bookmarks", for example.
  539.  • The <Tab> and <Shf Tab> keys now beep if a tab stop is not found.  This 
  540.  can be turned off by setting the 'searchNoisily' flag to false.  (Note:  
  541.  Other search operations in latex.tcl also beep; the 'searchNoisily' flag 
  542.  applies to all of them simultaneously.)
  543.  • Added a proc called 'nthTabStop' (bound to <Ctl Tab>) which generalizes 
  544.  the existing 'nextTabStop' and 'prevTabStop' routines by taking an 
  545.  arbitrary integer argument.
  546.  • Added a new Goto submenu containing the various navigation commands  
  547.  mentioned above.  Also included are commands for moving to and from the 
  548.  next and previous (sub)sections.  (See the docs for the corresponding 
  549.  command keys.)
  550.  • Added more than ten commands to the Boxes submenu, including \fbox, 
  551.  \sbox, \raisebox, \parbox, and \rule.  There's also a new minipage 
  552.  environment.
  553.  • Reorganized and enhanced the Spacing submenu with additional 
  554.  commands, the first half-dozen of which are listed in increasing order 
  555.  of "wideness".  Adjusted the corresponding command keys (all of which 
  556.  are a modified spacebar) so that they more closely match the order of 
  557.  the menu items.
  558.  • To facilitate file transfer, LaTeX 2e now has a 'filecontents' 
  559.  environment to contain the source of a LaTeX auxiliary file.
  560.  This new environment is supported in latex.tcl 2.2 on the Documents 
  561.  submenu.  Also on the Documents submenu are new commands for 
  562.  automatically inserting standard LaTeX 2e styles and packages.
  563.  • Implemented the International submenu, including most of the symbols 
  564.  and half of the accents.
  565.  • The \mathcal command on the Math Style submenu now checks to see that 
  566.  its argument is upper-case.
  567.  • Broke the latex.tcl source code into four parts:  latex.tcl, 
  568.  latexMode.tcl, latexMenu.tcl, and latexKeys.tcl.
  569.  • Fixed 'wordBreak' and 'wordBreakPreface' (thanks Pete!) so that the 
  570.  leading backslash is now selected when double-clicking a LaTeX command.
  571.  • The flags 'optionIsMeta' and 'useDollarSigns' (on the "flag" pop-up 
  572.  menu) are now dynamic in the sense that they may be changed at any time 
  573.  with immediate effect.
  574.  • Environments which prompt the user for input (enumerate, itemize, 
  575.  description, thebibliography, tabular, array, eqnarray, and eqnarray*) 
  576.  now do so on the status bar at the bottom of the screen.
  577.  
  578.  
  579. Changes in Version 2.0
  580.  
  581.  • The documentation (LaTeX Help and latex_commands.tex) has been totally 
  582.  rewritten.
  583.  • A new, expanded LaTeX menu has been implemented, following closely the 
  584.  organization and terminology of the LaTeX book.
  585.  • Ellipses have been added to LaTeX menu items where appropriate.
  586.  • Macros intelligently respond to the current selection---although
  587.  many objects simply replace the current selection (similar to Paste), 
  588.  others conveniently and automatically wrap themselves around it.  
  589.  Environments automatically wrap themselves around a selection, too.
  590.  • Functionality has been localized in utility macros as much as possible.
  591.  • Standard document types (letter, article, report, and book) have been 
  592.  added.  Simply select some text (or not) before choosing the desired 
  593.  command from the Documents menu.
  594.  • Three flags have been added to the Utils menu:  'useBoxMacro' (which 
  595.  controls the behavior of the figure environment), 'deleteObjectNoisily' 
  596.  (which controls an alert that appears when the current selection is 
  597.  about to be replaced by an object), and 'deleteEnvironmentNoisily' 
  598.  (which controls an alert that appears when the current selection is 
  599.  about to be replaced by an environment).
  600.  • Many new environments have been added (figure, table, verbatim, quote,
  601.  quotation, verse) and some (enumerate, itemize, description, tabular, 
  602.  bibliography, array, eqnarray, and eqnarray*) now prompt the user for 
  603.  the desired number of rows and, in some cases, columns.  The environment 
  604.  body is then constructed automatically.
  605.  • The figure environment now depends on a flag called 'useBoxMacro' on the
  606.  Utils menu.  If this flag is true (which it is by default), then the
  607.  figure environment inserts the string "\\centerline{\\$boxMacroName{•}}"
  608.  into its body.  Otherwise, the body of the figure environment is left
  609.  empty (unless there is a current selection, in which case the figure
  610.  environment wraps).
  611.  • A new, improved fraction macro now parses a selection of the form 
  612.  "numerator/denominator" and then automatically constructs the 
  613.  corresponding displayed fraction.  A selection not containing a  
  614.  "/" is inserted in lieu of the fraction's numerator.
  615.  • Both TeX and LaTeX math modes are supported, including $...$, $$...$$,
  616.  \(...\), and \[...\].  These are inserted into the document horizontal-
  617.  ly.  The corresponding multi-line environments \begin{math}...\end{math} 
  618.  and \begin{displaymath}...\end{displaymath} are also supported and 
  619.  heartily recommended (since these constructs are more easily modified 
  620.  and maintained by the user).
  621.  • There's now a two-parameter nth root, in addition to square root.
  622.  • Arbitrary one- and two-parameter LaTeX commands have been implemented, 
  623.  namely, \<command>{•} and \<command>{•}{•}.  These can be run inter-
  624.  actively, or used as templates for user-defined commands.
  625.  • In addition to sum and integral, numerous "large operators" (product, 
  626.  union, intersection, logical and/or) have been added.
  627.  • The nonumber command has been removed since it only appears in the 
  628.  context of an eqnarray environment.
  629.  • Both the Conjugate and Expected Value commands have been removed since 
  630.  in my (perhaps limited) experience these are nonstandard mathematical 
  631.  notation.
  632.  • Sectioning commands no longer insert a trailing carriage return.
  633.  • The Sum and Integral commands no longer typeset the current selection 
  634.  as the lower limit of the sum or integral.
  635.  • The command texDisplayEqn is no longer supported. Instead, the commands
  636.  MathModes:texDisplaymath and MathModes:latexDisplaymath insert 
  637.  themselves horizontally into the .tex file.  For vertical source code 
  638.  formatting, use MathEnvironments:Displaymath.
  639.  • Extraneous comments preceding each environment have been removed.
  640.  • The command alignEqual has been removed since the separator is now
  641.  inserted automatically into the appropriate environments.
  642.  
  643.  
  644. Changes in Version 1.2
  645.  
  646.  • **IMPORTANT**: KEYBINDINGS NOW DEPENDENT ON optionIsMeta FLAG
  647.  
  648.  • macros shortened through use of movePoint and selReplace utility macros.
  649.  • new macros added: section, subsection, subsubsection, enumerate,
  650.  itemize
  651.  • most short macros handle selected text (i.e. highlight "word", execute
  652.  the boldface command, and you get "{\bf word}").  NOTE: this is 
  653.  OPTIONAL--you can still execute boldface, type "word", and type tab.
  654.  • latex key bindings only performed the first time Tex mode is entered,
  655.  to save time
  656.  • emphasize macro updated
  657.  
  658.  
  659. Changes in Version 1.1
  660.  
  661.  • non-breaking space removed from cite macro
  662.  • slide environment macro added and assigned to o-F9 and c-o-9
  663.  • equation, displaymath, eqnarray, eqnarray*, slide, and general environment
  664.  now indent and no longer insert a blank line if called from column 0.
  665.  • texDisplayEqn ($$...$$) added and bound to o-s-4
  666.  
  667.